home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / basic / menurtns.zip / MENURTNS.DOC < prev    next >
Text File  |  1990-07-21  |  6KB  |  169 lines
  1.  
  2.                 MENURTNS.DOC for MENURTNS.QLB and MENURTNS.LIB
  3.  
  4.      The following documentation explains and gives examples of paramaters
  5. to pass to the Functions available in this QuickBASIC Library.  The
  6. following QuickBASIC Library contains seven routines as follows:
  7.  
  8. GetTime$()
  9.      This function can be used just as you would the DOS and BASICA TIME$
  10.      Function.  GetTime$ returns the time as 12 hour clock with am or pm.
  11.           EXAMPLE: PRINT GetTime$ could return "10:57 am"
  12.  
  13. GetDate$()
  14.      This function can be used just as you would the DOS and BASICA DATE$           Function.  GetDate$ returns the date as long international.
  15.           EXAMPLE: PRINT GetDate$ could return "August 25, 1990"
  16.  
  17. Shadow%(Row%, Col%)
  18.      This function will replace any character at the given location,
  19.      including blinking characters with the same character as Grey on Black.
  20.           EXAMPLE: Dummy = Shadow%(10, 10) would return a Grey on Black
  21.                    character if one exists.
  22.  
  23. WaitKey$(Row%, Col%, WaitText$)
  24.      This function will print the WaitText$ string at Row%, Col% on the
  25.      screen, wait for a key press and then return whatever key was pressed.
  26.           EXAMPLE:
  27.                   DO
  28.                      Response$ = WaitKey$(10, 10, "Press RETURN to continue")
  29.                   LOOP UNTIL Response$ = CHR$(13)
  30.  
  31. MenuBar%(Row%, Col%, MenuStr$, FgColor%, BgColor%, ReversedColor%)
  32.      This function will return the Integer number of the selection choosen.
  33.      The MenuBar% function automatically makes a one line menu with a
  34.      highlighted section of the bar that scrolls around the menu, or you can
  35.      choose a menu selection from the Hot keys which is the first letter of
  36.      each selection if Capitalized.  Colors are set within the parameters but
  37.      the Highlighted Foreground color will always be High-Intensity White.
  38.           EXAMPLE:
  39.      MenuStr$ = " Help  Menu-2  Time  Date  Quit "
  40.      SELECT CASE MenuBar%(10, 10, MenuStr$, Black, Cyan, Red)
  41.         CASE 1
  42.            This would be the Help selection
  43.         CASE 2
  44.            This would be the Menu-2 selection
  45.         CASE 3
  46.            This would be the Time selection
  47.         CASE 4
  48.            This would be the Date selection
  49.         CASE else
  50.            This would be the Quit selection
  51.      END SELECT
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                    (Page 1)
  63.  
  64.  
  65.  
  66.  
  67. MenuWindow%(Row%, Col%, ShadDir$, MenuTitle$, MenuStr$, OutLineColor%,_
  68.             WindowBgColor%, WindowFgColor%, ReversedColor%)
  69.      This function will return the Integer number of the selection choosen.
  70.      The MenuWindow% function automatically makes a window menu with a
  71.      highlighted section of the bar that scrolls up and down through the menu,
  72.      or you can choose a menu selection from the Hot keys which is the first
  73.      letter of each selection if Capitalized.  Colors are set within the
  74.      parameters but the Highlighted Foreground color will always be
  75.      High-Intensity White.  Also, a shadow can be specified with upper or
  76.      lower case "L" for left side, "R" for Right side or "" for no shadow.
  77.      The Menu Title will automatically be centered and truncated if
  78.      necessary to fit it within the box top.
  79.           EXAMPLE:
  80.      MenuStr$ = " Help  Menu-2  Time  Date  Quit "
  81.      SELECT CASE MenuWindow%(10, 10, "L", "MENU TITLE", MenuStr$, Blue,_
  82.             Cyan, Black, Red)
  83.         CASE 1
  84.            This would be the Help selection
  85.         CASE 2
  86.            This would be the Menu-2 selection
  87.         CASE 3
  88.            This would be the Time selection
  89.         CASE 4
  90.            This would be the Date selection
  91.         CASE else
  92.            This would be the Quit selection
  93.      END SELECT
  94.  
  95. DrawBox(URow%, UCol%, LRow%, LCol%, ShadDir$, BoxTitle$, OutLineColor%,_
  96.         WindowBgColor%, WindowFgColor%)
  97.      The DrawBox sub will draw a box at the given location specified by
  98.      the upper left corner and the lower right corner.  Colors are set
  99.      within the parameters.  Also, a shadow can be specified with upper or
  100.      lower case "L" for left side, "R" for Right side or "" for no shadow.
  101.      The Box Title will automatically be centered and truncated if necessary
  102.      to fit it within the box top.
  103.           EXAMPLE:
  104.      CALL DrawBox(2, 9, 14, 74, "l", "BOX TITLE", Blue, Cyan, White + Bright)
  105.  
  106.  
  107.      NOTE:
  108.  
  109.      As a QuickBASIC hobbyist programmer, I'm sure that anyone that has
  110. received this Library is, or is on the way to becoming a QuickBASIC
  111. programming enthusiast also.  This is my first attempt at a SHAREWARE
  112. product, and will more than likely determine if I will produce any more
  113. software for SHAREWARE.
  114.  
  115.      As seen above, I have created several functions that may enhance many
  116. programs that other programmers such as yourself has spent many hours
  117. creating.  So, below I have created a Registration form for anyone that
  118. thinks they may use any of these routines in programs for other than your
  119. own use.  If your just going to use these routines for your own programs,
  120. then no registration is necessary, otherwise, you can specify your own
  121. registration fee, depending on your anticipated use.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                    (Page 2)
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                          REGISTRATION FOR MENURTNS.LIB
  137.  
  138.  
  139.               NAME:_____________________________________________
  140.  
  141.             STREET:_____________________________________________
  142.  
  143.               CITY:________________ STATE:__ ZIP CODE __________
  144.  
  145.  
  146.  
  147.                     SUGGESTED REGISTRATION FEES OUTLINE:
  148.  
  149.                     Personal Use: ---------------   FREE
  150.  
  151.                     Light User: ----------------- $ 5.00
  152.  
  153.                     Moderate User: -------------- $10.00
  154.  
  155.                     Heavy User: ----------------- $15.00
  156.  
  157.                     Source Code: ---------------- $25.00
  158.  
  159.                     Diskette and Diskette Mailer: $ 2.50
  160.                     or Send Diskette and Mailer
  161.  
  162.  
  163.                     Please send registration form to:
  164.  
  165.                     Robert R. Smith
  166.                     3812 Red Bud
  167.                     Imperial, MO  63052-1161
  168.  
  169.